home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / Think Class Libraries / TP TCL->CW TCL v1.1.2.3 / UPI ƒ / Porting to UPIs ƒ / Porting to UPI FAQ v1.0 next >
Text File  |  1996-04-20  |  7KB  |  288 lines

  1. Porting to UPI FAQ v1.0 - by Vik Rubenfeld, April 1996
  2. ------------------------------------------------------
  3. The purpose of this FAQ is to provide information regarding updating an application for use with the Universal Headers.
  4.  
  5. Routine Names
  6. -------------
  7. The names of some routines have changed.
  8.  
  9. Here is the old routines/new routines translation dictionary, courtesy of Bill Catambay.
  10.  
  11. Old NAME New NAME
  12.  
  13. #################
  14. # AppleEvents
  15. #################
  16. AEPutKeyPtr AEPutParamPtr
  17. AEPutKeyDesc AEPutParamDesc
  18. AEGetKeyPtr AEGetParamPtr
  19. AEGetKeyDesc AEGetParamDesc
  20. AESizeOfKeyDesc AESizeOfParam
  21. AEDeleteKeyDesc AEDeleteParam
  22.  
  23.  
  24. #################
  25. # CodeFragments (types and constants)
  26. #################
  27. ConnectionID CFragConnectionID
  28. LoadFlags CFragLoadOptions
  29. SymClass CFragSymbolClass
  30. MemFragment CFragOldMemoryLocator
  31. DiskFragment CFragHFSDiskFlatLocator
  32. SegmentedFragment CFragHFSSegmentedLocator
  33. FragmentLocator CFragHFSLocator 
  34. FragmentLocatorPtr CFragHFSLocatorPtr
  35. InitBlock CFragInitBlock
  36. InitBlockPtr  CFragInitBlockPtr
  37. ConnectionInitializationRoutine CFragInitFunction
  38. ConnectionTerminationRoutine  CFragTermRoutine
  39. kPowerPCArch kPowerPCCFragArch
  40. kMotorola68KArch kMotorola68KCFragArch
  41. kAnyArchType kAnyCFragArch
  42. kLoadLib kLoadCFrag
  43. kFindLib kFindCFrag
  44. kLoadNewCopy kNewCFragCopy
  45. kUseInPlace kInplaceCFrag
  46. kCodeSym kCodeCFragSymbol
  47. kDataSym kDataCFragSymbol
  48. kTVectSym kTVectorCFragSymbol
  49. kTOCSym kTOCCFragSymbol
  50. kGlueSym kGlueCFragSymbol
  51. kInMem kMemoryCFragLocator
  52. kOnDiskFlat kDataForkCFragLocator
  53. kOnDiskSegmented kResourceCFragLocator
  54. kIsLib kImportLibraryCFrag
  55. kIsApp kApplicationCFrag
  56. kIsDropIn kDropInAdditionCFrag
  57. kFullLib kIsCompleteCFrag
  58. kUpdateLib kFirstCFragUpdate
  59. kCFMRsrcType kCFragResourceType
  60. kCFMRsrcID kCFragResourceID
  61. kSHLBFileType kCFragLibraryFileType
  62. kUnresolvedSymbolAddress kUnresolvedCFragSymbolAddress
  63.  
  64.  
  65. #################
  66. # Controls
  67. #################
  68. SetCTitle SetControlTitle
  69. GetCTitle GetControlTitle
  70. UpdtControl UpdateControls
  71. SetCtlValue SetControlValue
  72. GetCtlValue GetControlValue
  73. SetCtlMin SetControlMinimum
  74. GetCtlMin GetControlMinimum
  75. SetCtlMax SetControlMaximum
  76. GetCtlMax GetControlMaximum
  77. GetAuxCtl GetAuxiliaryControlRecord
  78. SetCRefCon SetControlReference 
  79. GetCRefCon GetControlReference
  80. SetCtlAction SetControlAction
  81. GetCtlAction GetControlAction
  82. SetCtlColor SetControlColor
  83. GetCVariant GetControlVariant
  84.  
  85.  
  86. #################
  87. # CTBUtilities
  88. #################
  89. NuLookup StandardNBP
  90. NuPLookup CustomNBP
  91.  
  92.  
  93. #################
  94. # Dialogs
  95. #################
  96. DisposDialog DisposeDialog
  97. UpdtDialog UpdateDialog
  98. GetDItem GetDialogItem
  99. SetDItem SetDialogItem
  100. HideDItem HideDialogItem
  101. ShowDItem ShowDialogItem
  102. SelIText SelectDialogItemText
  103. GetIText GetDialogItemText
  104. SetIText SetDialogItemText
  105. FindDItem FindDialogItem
  106. NewCDialog NewColorDialog
  107. GetAlrtStage GetAlertStage
  108. ResetAlrtStage ResetAlertStage
  109. DlgCut DialogCut
  110. DlgCopy DialogCopy
  111. DlgPaste DialogPaste
  112. DlgDelete DialogDelete
  113. SetDAFont SetDialogFont
  114.  
  115.  
  116. #################
  117. # Events
  118. #################
  119. KeyTrans KeyTranslate
  120.  
  121.  
  122. #################
  123. # Lists
  124. #################
  125. LDoDraw LSetDrawingMode
  126. LFind LGetCellDataLocation
  127.  
  128.  
  129. #################
  130. # Memory
  131. #################
  132. ApplicZone ApplicationZone
  133. MFTempNewHandle TempNewHandle
  134. MFMaxMem TempMaxMem
  135. MFFreeMem TempFreeMem
  136. MFTempHLock TempHLock
  137. MFTempHUnlock TempHUnlock
  138. MFTempDisposHandle TempDisposeHandle
  139. MFTopMem TempTopMem
  140. ResrvMem ReserveMem
  141. DisposPtr DisposePtr
  142. DisposHandle DisposeHandle
  143. ReallocHandle ReallocateHandle
  144.  
  145.  
  146. #################
  147. # Menus
  148. #################
  149. AddResMenu AppendResMenu
  150. InsMenuItem InsertMenuItem
  151. DelMenuItem DeleteMenuItem
  152. SetItem SetMenuItemText
  153. GetItem GetMenuItemText
  154. GetMHandle GetMenuHandle
  155. DelMCEntries DeleteMCEntries
  156. DispMCInfo DisposeMCInfo
  157.  
  158.  
  159. #################
  160. # OSUtils
  161. #################
  162. LongDate2Secs LongDateToSeconds
  163. LongSecs2Date LongSecondsToDate
  164. IUMetric IsMetric
  165. Date2Secs DateToSeconds
  166. Secs2Date SecondsToDate
  167.  
  168.  
  169. #################
  170. # PictUtils
  171. #################
  172. DisposPictInfo DisposePictInfo
  173.  
  174.  
  175. #################
  176. # Quickdraw
  177. #################
  178. DisposPixMap DisposePixMap
  179. DisposPixPat DisposePixPat
  180. DisposCTable DisposeCTable
  181. DisposCCursor DisposeCCursor
  182. DisposCIcon DisposeCIcon
  183. DisposGDevice DisposeGDevice
  184.  
  185.  
  186. #################
  187. # QuickdrawText
  188. #################
  189. NPixel2Char PixelToChar
  190. NChar2Pixel CharToPixel
  191. NDrawJust DrawJustified
  192. NMeasureJust MeasureJustified
  193. NPortionText PortionLine
  194.  
  195.  
  196. #################
  197. # QuickTime
  198. #################
  199. ClockGetTime GetClockTime
  200.  
  201. #################
  202. # Resources
  203. #################
  204. SizeResource GetResourceSizeOnDisk
  205. MaxSizeRsrc GetMaxResourceSize
  206. RmveResource RemoveResource
  207.  
  208.  
  209. #################
  210. # Script
  211. #################
  212. SetSysJust SetSysDirection
  213. GetSysJust GetSysDirection
  214. Font2Script FontToScript
  215. GetEnvirons GetScriptManagerVariable
  216. SetEnvirons SetScriptManagerVariable
  217. IUGetIntl GetIntlResource
  218. IUSetIntl SetIntlResource
  219. IUClearCache ClearIntlResourceCache
  220. IUGetItlTable GetIntlResourceTable
  221.  
  222.  
  223. #################
  224. # TextEdit
  225. #################
  226. TESetJust TESetAlignment
  227. TextBox TETextBox
  228. TEStylNew TEStyleNew
  229. SetStylHandle TESetStyleHandle
  230. SetStyleHandle TESetStyleHandle
  231. GetStylHandle TEGetStyleHandle
  232. GetStyleHandle TEGetStyleHandle
  233. TEStylPaste TEStylePaste
  234. GetStylScrap TEGetStyleScrapHandle
  235. GetStyleScrap TEGetStyleScrapHandle
  236. SetStylScrap TEUseStyleScrap
  237. SetStyleScrap TEUseStyleScrap
  238. SetClikLoop TESetClickLoop
  239. TEGetScrapLen TEGetScrapLength
  240. TESetScrapLen TESetScrapLength
  241. SetWordBreak TESetWordBreak
  242. TEStylInsert TEStyleInsert
  243.  
  244.  
  245. #################
  246. # TextUtils
  247. #################
  248. FormatX2Str ExtendedToString
  249. UprString UpperString
  250. String2Date StringToDate
  251. String2Time StringToTime
  252. FormatX2Str ExtendedToString
  253. FormatStr2X StringToExtended
  254. Str2Format StringToFormatRec
  255. Format2Str FormatRecToString
  256. IUDatePString DateString
  257. IUTimePString TimeString
  258. IULDateString LongDateString
  259. IULTimeString LongTimeString
  260. IUCompPString CompareString
  261. IUEqualPString IdenticalString
  262. IUMagPString CompareText
  263. IUMagIDPString IdenticalText
  264. IULangOrder LanguageOrder
  265. IUTextOrder TextOrder
  266. IUStringOrder StringOrder
  267.  
  268.  
  269. Other Points Of Interest When Porting To Universal Headers
  270. ----------------------------------------------------------
  271. A number of routines that used to take a boolean parameter called Sync or Async, such as PBGetCatInfo, have now been replaced with procedures such as PBGetCatInfoSync and PBGetCatInfoASync.
  272.  
  273. OS constants are defined in units, e.g. Geneva is in the Fonts unit. If you find a constant that appears to be undefined, search the Universal Interfaces until you find the unit that contains it- then include that unit by means of a USES statement.
  274.  
  275. The names of some constants have been changed. For example, InButton is now kControlButtonPart. If you run into this, search the Universal Headers for the old constant name, and look in that file to identify the new constant name. 
  276.  
  277. Routines like CustomGetFile that used to take a TypeList, now take a ptr to a typelist, i.e. @theTypeList. This is to permit TypeLists with more than 4 types.
  278.  
  279. QuickDraw globals such as thePort, and constants such as White, Gray, etc., now have to be referenced as qd.thePort, qd.white, qd.gray, etc.
  280.  
  281. SANE
  282. ----
  283. Sane is no longer available under the Universal Headers. I have coded the enclosed Sane2FP unit, which implements many of the most-frequently called Sane routines (including Num2Str, Str2Num, and others) under the Universal Headers. Just drop it into your project to have access to those routines.
  284.  
  285.  
  286.  
  287.  
  288.